feat: Add avatar-live and reference image support#19
Merged
AdirAmsalem merged 9 commits intomainfrom Jan 18, 2026
Merged
Conversation
- Add avatar-live realtime model with set_image() method - Add lucy-restyle-v2v video model with reference_image support - Add AvatarOptions for configuring avatar image on connect - Add VideoRestyleInput with mutual exclusivity validation - Add comprehensive tests for both features
- Introduced a Gradio-based test UI for easy feature testing. - Added functionality for image and video generation, transformation, and restyling. - Included a tokens API for creating short-lived client tokens. - Updated README with instructions for using the test UI.
- Update image ACK message type from 'image_set' to 'set_image_ack' - Change ACK format to use success:bool + error:string - Add initial_prompt option for sending prompt before WebRTC handshake - Add ErrorMessage, ReadyMessage, and IceRestartMessage types - Add ICE restart with TURN server support - Update tests for new message format and initial_prompt feature
AdirAmsalem
deleted the
feature/api-692-avatar-live-reference-img-python-sdk
branch
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
avatar-liverealtime model withset_image()method for dynamic avatar updateslucy-restyle-v2vvideo model withreference_imagesupport (mutually exclusive with prompt)AvatarOptionsdataclass for configuring avatar image on connectVideoRestyleInputwith validation for prompt/reference_image mutual exclusivityinitial_promptoption for sending prompt before WebRTC handshakeset_image_ackwithsuccess/errorfieldsChanges
Avatar Live (Realtime API)
models.realtime("avatar-live")AvatarOptionsfor passing avatar image on connectInitialPromptOptionsfor sending prompt before WebRTC handshakeset_image()method onRealtimeClientfor runtime avatar updatesSetAvatarImageMessage,SetImageAckMessageMessage Types
SetImageAckMessagewithsuccess: boolanderror: Optional[str]ErrorMessagefor server error handlingReadyMessagefor server ready signalIceRestartMessagewithTurnConfigfor ICE restart supportReference Image (Queue API)
models.video("lucy-restyle-v2v")reference_imageparameter (mutually exclusive withprompt)enhance_promptonly valid with text promptTest plan